home *** CD-ROM | disk | FTP | other *** search
/ Almathera Ten Pack 3: CDPD 3 / Almathera Ten on Ten - Disc 3: CDPD3.iso / fish / 726-750 / 747 / adoc / adoc.doc < prev    next >
Text File  |  1995-03-18  |  26KB  |  529 lines
  1.  
  2.  
  3. AboutThisDoc
  4.    
  5.           Ce manuel décrit la version 1.20 de l'utilitaire ADoc2. Ce  programme
  6.   est (c)1990-1991-1992 par Denis GOUNELLE, toute  utilisation  commerciale  ou
  7.   vente sans autorisation écrite est strictement interdite. Vous pouvez  copier
  8.   et diffuser ce programme aux conditions suivantes :
  9.  
  10.         - l'ensemble des fichiers doit être fourni
  11.         - aucun fichier ne doit avoir été modifié
  12.         - vous ne devez pas demander plus de 40FF pour cela
  13.    
  14.           "PowerPacker 2.3b"  est  (c)1989  par  PowerPeak  et  Nico  FRANCOIS,
  15.   "PowerPacker Pro 3.0b" est (c)1990 par PowerPeak  et  par  UGA  Software.  La
  16.   bibliothèque  "powerpacker.library"  est  (c)1990  par  Nico   FRANCOIS.   La
  17.   bibliothèque "reqtools.library" est (c)1991-1992 par Nico FRANCOIS. AREXX est
  18.   (c)1987 par William Hawes.
  19.  
  20.           Malgré de nombreux tests, je ne peux  garantir  qu'ADoc  ne  contient
  21.   aucune erreur. VOUS UTILISEZ CE PROGRAMME A VOS  RISQUES  ET  PERILS.  Je  ne
  22.   pourrai en aucun cas  être  tenu  responsable  de  tout  dommage,  direct  ou
  23.   indirect, résultant de l'utilisation d'ADoc.
  24.  
  25.                    >>> FERMEZ CETTE FENETRE POUR CONTINUER <<<
  26.    
  27. Introduction
  28.    
  29.           ADoc2 est une nouvelle version de ADoc, qui a été réécrit entièrement
  30.   afin de supprimer certaines  limitations  et  de  pouvoir  ajouter  plusieurs
  31.   améliorations.  Notez   que   certaines   incompatibilités   sont   apparues,
  32.   principalement au niveau des arguments. Ce programme fonctionne  de  la  même
  33.   façon sous les versions 1.3 et 2.0 du système.
  34.  
  35.           ADoc est un utilitaire permettant de  gérer  des  documentations  sur
  36.   n'importe quel sujet. Il est capable de lancer automatiquement  la  recherche
  37.   d'un mot désigné à la souris, et peut travailler sur plusieurs fichiers à  la
  38.   fois. ADoc peut  également  utiliser  directement  les  fichiers  AutoDoc  de
  39.   Commodore,  ainsi  que  des  fichiers  compactés  à  l'aide  de  l'utilitaire
  40.   "PowerPacker".
  41.  
  42.           Vous pouvez me faire part de vos remarques ou critiques sur ADoc,  en
  43.   écrivant à l'adresse suivante :
  44.  
  45.                                 M. GOUNELLE Denis
  46.                                     Boîte 71
  47.                                6, rue des cailloux
  48.                               92110 CLICHY - FRANCE
  49.    
  50.           Merci à Jean-Yves PROUX et à Helmut J. ESENWEIN pour leurs nombreuses
  51.   suggestions, ainsi qu'à Simon HEWINSON  pour  la  traduction  en  anglais  du
  52.   fichier "amiga.doc". Remerciements particuliers à Jean-Philippe RAPP pour ses
  53.   idées, et pour m'avoir permis de tester ADoc sur les fichiers AutoDoc.
  54.  
  55. PrincipesDeFonctionnement
  56.    
  57.           ADoc travaille à partir de fichiers de documentation,  qui  associent
  58.   un texte à un mot-clé (appelé "terme" dans  cette  documentation).  A  chaque
  59.   fichier de documentation est associé un fichier d'index, qui permet d'accéder
  60.   presque  instantanément  aux  termes  recherchés  (notez  que  ceci  a   pour
  61.   conséquence  qu'il  faudra  reconstruire  le   fichier   d'index   à   chaque
  62.   modification du fichier de documentation). Seul le fichier d'index est chargé
  63.   en mémoire lors de l'utilisation. Le nom du fichier  d'index  est  obtenu  en
  64.   ajoutant le suffixe ".index" au nom du fichier de documentation.
  65.  
  66.           Les fichiers de documentation, que  vous  pouvez  créer  vous-même  à
  67.   l'aide de votre éditeur de texte  favori,  sont  constitués  d'une  série  de
  68.   définitions, chaque définition ayant la syntaxe suivante :
  69.  
  70.                   terme
  71.                           première ligne de texte
  72.                           seconde ligne de texte
  73.                            
  74.                           etc...
  75.                            
  76.                           n-ième ligne de texte
  77.    
  78.           Dans un premier temps, considérez que les deux  premières  lignes  du
  79.   fichier doivent être vides (ou à la rigueur commencer par un  espace  ou  une
  80.   tabulation). Il est absolument indispensable  que  le  premier  caractère  du
  81.   terme soit en colonne 1, et que les lignes de texte commencent par un  espace
  82.   ou une tabulation. Les lignes vides sont autorisées.
  83.  
  84.                                 NOTE IMPORTANTE :
  85.    
  86.       Le format des fichiers de documentation n'est plus le même  que  pour
  87.       les version 3.xx et 4.xx. 
  88.    
  89.           Un terme ne peut faire plus de 32 caractères, et ne peut contenir  ni
  90.   espaces ni tabulations : les caractères autorisés sont les lettres minuscules
  91.   et majuscules, les chiffres, le souligné et les caractères  accentués  (codes
  92.   ASCII compris entre 217 et 246). Il est cependant possible d'étendre  le  jeu
  93.   des caractères autorisés si besoin (voir paragraphe ConceptsAvancés). 
  94.           Le nombre de termes par fichier, et de lignes de texte par terme,  ne
  95.   sont pas limités (ou plutôt, cette limite est si  grande  que  vous  serez  à
  96.   court de mémoire bien avant).
  97.  
  98.           La longueur maximale d'une ligne de texte est de 256 caractères. Afin
  99.   de mettre en valeur certaines parties du  texte,  vous  pouvez  utiliser  les
  100.   séquences ANSI suivantes :
  101.  
  102.                   ESC[1m  début caractères gras
  103.                   ESC[3m  début caractères italiques
  104.                   ESC[4m  début caractères soulignés
  105.                   ESC[22m fin caractères gras
  106.                   ESC[23m fin caractères italiques
  107.                   ESC[24m fin caractères soulignés
  108.                   ESC[0m  caractères normaux
  109.    
  110. AppelDepuisLeCLI
  111.    
  112.   ADoc peut s'utiliser aussi bien depuis le CLI que depuis le  Workbench.  Lors
  113.   de l'appel depuis le CLI, vous pouvez indiquer les arguments suivants :
  114.  
  115.   WBENCH 
  116.       Demande à ADoc d'utiliser l'écran du Workbench. Si cet argument est omis,
  117.       ADoc ouvrira  son  propre  écran,  de  la  même  taille  que  l'écran  du
  118.       Workbench. En cas d'erreur lors de l'ouverture de cet écran, ADoc passera
  119.       automatiquement sur l'écran du Workbench.
  120.  
  121.   LACE 
  122.       Demande à ADoc d'utiliser un  écran  en  mode  entrelacé.  Si  vous  avez
  123.       demandé à utiliser l'écran du Workbench, et que cet écran  n'est  pas  en
  124.       mode entrelacé, cet argument sera ignoré.
  125.  
  126.   FONT nom 
  127.       Demande à ADoc d'utiliser la police de caractères indiquée, plutôt que la
  128.       police   par    défaut.    Le    nom    doit    être    de    la    forme
  129.       <NomDeLaPolice><TailleEnY>,  par  exemple  "topaz8".  ADoc  est   capable
  130.       d'utiliser n'importe quelle police non  proportionnelle,  pourvu  que  sa
  131.       taille soit d'au moins 8. 
  132.       Si ADoc ne peut ouvrir la police  demandée,  il  essaiera  d'utiliser  la
  133.       police par défaut. Si cette police ne convient pas, ou si  ADoc  ne  peut
  134.       l'ouvrir, il essaiera d'accéder à la police  Topaz,  en  taille  8.  S'il
  135.       échoue, le programme s'arrêtera immédiatement.
  136.  
  137.   MAKEIDX 
  138.       Indique à ADoc que la seule opération à effectuer  est  la  création  des
  139.       fichiers d'index.
  140.  
  141.   QUICK 
  142.       Demande  à  ADoc  de  ne  pas  afficher  le  texte   associé   au   terme
  143.       "AboutThisDoc" au démarrage. Normalement, à chaque fois que ADoc ouvre un
  144.       fichier, il cherche le terme "AboutThisDoc" dans ce  fichier  puis,  s'il
  145.       existe,  affiche le texte correspondant et attend que l'utilisateur ferme
  146.       la fenêtre pour continuer.
  147.  
  148.   AREXX 
  149.       Demande à ADoc de passer en mode  AREXX.  L'utilisation  avec  AREXX  est
  150.       détaillée au paragraphe ModeAREXX.
  151.  
  152.   NOCASE 
  153.       Demande à ADoc de ne pas différencier minuscules et majuscules lors de la
  154.       gestion des fichiers. Cela ne concernera que les fichiers dont le nom est
  155.       indiqué après cette option.
  156.  
  157.   NOSORT 
  158.       Demande à ADoc de ne pas trier l'index  des  fichiers  dont  le  nom  est
  159.       indiqué après cette option.
  160.  
  161.   TABSIZE n 
  162.       Indique la taille des tabulations pour  les  fichiers  dont  le  nom  est
  163.       indiqué après cette option. La taille par défaut est de 8. 
  164.    
  165.   Tout autre argument est considéré comme un nom de fichier de documentation  à
  166.   utiliser. Vous pouvez indiquer plusieurs fichiers, en séparant les  noms  par
  167.   des espaces ou par une virgule (par exemple "ADoc fichier1 fichier2" ou "ADoc
  168.   fichier1,fichier2"). Vous pouvez mélanger noms de fichiers et  options,  mais
  169.   n'oubliez pas que les options NOCASE, NOSORT, et TABSIZE ne concerneront  que
  170.   les fichiers indiqués après ces  options.  ADoc  ouvrira  les  fichiers  dans
  171.   l'ordre indiqué. A moins que vous n'indiquiez un chemin complet, les fichiers
  172.   sont recherchés d'abord dans le répertoire courant, puis dans  le  répertoire
  173.   "ADOC:". Si vous indiquez un nom de répertoire au lieu d'un nom  de  fichier,
  174.   tous les fichiers de ce répertoire (à l'exception  des  fichiers  ".info"  et
  175.   ".index") seront ouverts.
  176.  
  177. AppelDepuisLeWorkbench
  178.    
  179.   Depuis le Workbench, vous pouvez appeler ADoc de plusieurs façons :
  180.  
  181.     - en double-cliquant sur l'icône de ADoc (le fichier de  documentation  par
  182.       défaut sera utilisé) 
  183.     - en double-cliquant sur l'icône d'un fichier qui a ADoc  comme  outil  par
  184.       défaut (champ "DEFAULT TOOL") 
  185.     - en cliquant sur les icônes de plusieurs  fichiers,  tout  en  gardant  la
  186.       touche SHIFT appuyée, puis en double-cliquant sur l'icône de ADoc. 
  187.    
  188.   Dans tous les cas, ADoc commence  par  examiner  le  champ  "TOOL  TYPES"  de
  189.   l'icône du programme, qui peut contenir :
  190.  
  191.       FONT=nom 
  192.       OPTIONS=[WBENCH][LACE][MAKEIDX][QUICK][AREXX]
  193.  
  194.   Pour plus de détails sur ces options, voir  le  paragraphe  AppelDepuisLeCLI.
  195.   Notez que les noms des options doivent être séparés  par  un  caractère  "|".
  196.   ADoc ouvre ensuite les  fichiers  de  documentation  éventuellement  indiqués
  197.   exactement de la même façon que lors de l'appel depuis le CLI (notamment vous
  198.   pouvez indiquer un répertoire au lieu d'un fichier), à la différence  que  le
  199.   champ "TOOL TYPES" de chaque icône est examiné, et peut contenir :
  200.  
  201.       TABSIZE=n 
  202.       OPTIONS=[NOCASE][NOSORT]
  203.  
  204.   Pour plus de détails sur ces options, voir  le  paragraphe  AppelDepuisLeCLI.
  205.   Notez que ces trois options ne concerneront que le  fichier  correspondant  à
  206.   l'icône.
  207.  
  208. DémarrageDuProgramme
  209.    
  210.           ADoc utilise la version 2.0c de la  bibliothèque  "reqtools.library".
  211.   Vous devez donc copier cette bibliothèque dans le répertoire "LIBS:",  si  ce
  212.   n'est déjà fait. 
  213.           Comme expliqué dans les deux paragraphes  précédents,  ADoc  commence
  214.   par ouvrir le (ou les) fichier(s) indiqué(s). Lors de cette phase, ADoc tente
  215.   également de charger le fichier d'index correspondant  à  chaque  fichier  de
  216.   documentation. Si vous n'avez indiqué aucun nom de  fichier  à  ouvrir,  ADoc
  217.   regarde si la variable "ADocFile"  est  définie  :  si  oui,  sa  valeur  est
  218.   utilisée. Si non, le fichier de documentation  par  défaut  est  "Amiga.doc".
  219.   Notez  que  vous  pouvez  indiquer  plusieurs  fichiers  dans   la   variable
  220.   "ADocFile", de la même façon que depuis la ligne de  commande  (par  exemple:
  221.   setenv ADocFile "exec.doc dos.doc"). 
  222.           Si le fichier d'index est introuvable,  ADoc  vous  proposera  de  le
  223.   créer. Si vous refusez, ce fichier de documentation ne sera  pas  utilisable,
  224.   mais ADoc essaiera quand même d'ouvrir les autres fichiers. 
  225.           Si ADoc détecte que le fichier de documentation a été  modifié  après
  226.   la création de l'index, il vous proposera de  mettre  le  fichier  d'index  à
  227.   jour. Si vous refusez, le fichier de documentation sera  quand  même  ouvert,
  228.   mais ADoc pourra détecter des erreurs ultérieurement  si  le  contenu  de  ce
  229.   fichier a été changé. Notez que la date de création du  fichier  d'index  est
  230.   mémorisée dans le fichier d'index lui-même.
  231.  
  232.           Une fois tous  les  fichiers  ouverts,  ADoc  affiche  une  boîte  de
  233.   requête,  indiquant  la  liste  des  termes  du   premier   fichier   ouvert.
  234.   L'utilisation  de  cette  boîte  de  requête  est   décrite   au   paragraphe
  235.   RequêteDeTerme.
  236.  
  237. RequêteDeTerme
  238.    
  239.           Vous pouvez désigner un terme à l'aide  de  la  souris,  en  cliquant
  240.   dessus. Le terme s'affiche alors dans une autre couleur. Si vous cliquez  une
  241.   seconde fois sur ce terme, la requête disparait  et  ADoc  affiche  le  texte
  242.   correspondant au terme dans une fenêtre. L'utilisation de  ces  fenêtres  est
  243.   décrite au paragraphe GestionDesFenêtres.
  244.  
  245.           Vous pouvez également vous servir du clavier pour faire votre  choix.
  246.   Si vous appuyez sur une lettre  quelconque,  cette  lettre  sera  ajoutée  au
  247.   "préfixe" courant (affiché dans le rectangle  en  dessous  de  la  liste  des
  248.   termes), et l'affichage de la liste des termes se fera à  partir  du  premier
  249.   terme commençant par ce préfixe. ADoc complètera ce préfixe le plus possible.
  250.   Si vous appuyez sur la touche <BACKSPACE> (au-dessus de la touche  <RETURN>),
  251.   le dernier caractère du préfixe sera effacé et l'affichage de la liste mis  à
  252.   jour également. Si vous appuyez sur la touche  <RETURN>,  ADoc  affichera  le
  253.   texte correspondant au premier terme commençant par  le  préfixe.  Notez  que
  254.   ADoc ne différenciera pas  minuscules et majuscules si le fichier  courant  a
  255.   été indiqué après une option NOCASE.
  256.  
  257.           Vous pouvez fermer la requête sans rien choisir, en appuyant  sur  la
  258.   touche <ESC> ou en cliquant sur le  gadget  de  fermeture.  Si  aucune  autre
  259.   fenêtre n'est ouverte à ce moment, le programme s'arrêtera.
  260.  
  261.           La requête de terme est en fait capable de vous  permettre  un  choix
  262.   parmi trois listes : la liste des termes du fichier  courant,  la  liste  des
  263.   fichiers (à condition qu'il y ait plusieurs fichiers ouverts) et la liste des
  264.   termes trouvés lors de la dernière recherche (à  condition  qu'une  recherche
  265.   ait déjà été effectuée, voir paragraphe Recherche). La lettre écrite dans  le
  266.   coin inférieur droit de la requête vous indique quelle liste est  affichée  :
  267.   liste des termes (T), liste des fichiers (F), liste des termes trouvés (S). 
  268.           Pour passer d'une liste à l'autre, appuyez sur le bouton droit de  la
  269.   souris tout en appuyant sur une des  touches  SHIFT.  Lorsque  la  liste  des
  270.   fichiers est affichée et que sélectionnez un des  fichiers  de  cette  liste,
  271.   ADoc repasse automatiquement à la liste des termes et affiche  la  liste  des
  272.   termes du fichier que vous avez choisi.
  273.  
  274.           Si aucune autre fenêtre n'est ouverte, la requête  de  terme  dispose
  275.   d'un menu avec trois options. La premiere vous permet de lancer une recherche
  276.   (voir paragraphe Recherche), la seconde vous permet  d'iconifier  ADoc  (voir
  277.   paragraphe LeMenuProjet) et la dernière vous permet de quitter ADoc.
  278.  
  279. GestionDesFenêtres
  280.    
  281.           Lorsque vous sélectionnez un  terme,  ADoc  ouvre  une  fenêtre  pour
  282.   afficher le texte correspondant. Si le terme est défini plusieurs  fois  dans
  283.   le même fichier, ou dans plusieurs fichiers différents, toutes les lignes  de
  284.   texte seront mises à la suite les unes des  autres,  et  affichées  dans  une
  285.   seule fenêtre. La hauteur  de  la  fenêtre  dépend  du  nombre  de  lignes  à
  286.   afficher. S'il y a trop de lignes, seule la première page  sera  affichée  et
  287.   ADoc ajoutera deux gadgets en forme de flèches (dans le coin supérieur droit)
  288.   à la fenêtre, pour vous permettre de faire défiler le texte.
  289.  
  290.           Bien entendu, il est possible d'avoir plusieurs fenêtres  ouvertes  à
  291.   la fois.  Par  défaut,  les  fenêtres  disposent  des  gadgets  standards  de
  292.   fermeture, de déplacement, de changement de plan, et de changement de taille.
  293.   Si  vous  modifiez  la  taille  d'une  fenêtre,  ADoc  ajoutera  ou  enlevera
  294.   automatiquement les gadgets en forme de flèches suivant les  besoins.  Chaque
  295.   fenêtre dispose également de trois menus, les  menus  "Projet",  "Outils"  et
  296.   "Spécial" (ces menus sont décrits aux paragraphes LeMenuProjet,  LeMenuOutils
  297.   et LeMenuSpécial). Notez enfin que vous pouvez fermer une fenêtre en appuyant
  298.   sur la touche <ESC>, et utiliser les touches <HAUT> et <BAS> du curseur  pour
  299.   faire défiler le texte page par page.
  300.  
  301.           Si vous cliquez sur un mot quelconque, ce mot sera affiché  dans  une
  302.   couleur différente. Si vous cliquez une seconde fois sur ce mot, ADoc lancera
  303.   automatiquement la recherche du terme correspondant, dans tous  les  fichiers
  304.   ouverts.  En  cas  d'échec  l'écran  flashera,  sinon  une  nouvelle  fenêtre
  305.   apparaitra.
  306.  
  307. LeMenuProjet
  308.    
  309.   Autre terme 
  310.       Fait apparaître la requête de terme (voir paragraphe RequêteDeTerme).
  311.  
  312.   Imprime 
  313.       Imprime  le  texte  contenu  dans  la  fenêtre  active.  Notez  que   les
  314.       éventuelles  séquences  ANSI   seront   correctement   interprétées   par
  315.       l'imprimante.
  316.  
  317.   Iconifie 
  318.       Met ADoc en sommeil : si ADoc avait ouvert son propre écran celui-ci  est
  319.       fermé, puis toutes les fenêtres disparaissent et ADoc  ouvre  une  petite
  320.       fenêtre en haut de l'écran du Workbench. Si vous cliquez sur le gadget de
  321.       fermeture de cette fenêtre, ADoc vous  demandera  confirmation  avant  de
  322.       quitter. Pour "réveiller" ADoc, activez la  fenêtre  et  appuyez  sur  le
  323.       bouton droit de la souris. 
  324.       Normalement, ADoc garde en mémoire toutes les lignes  de  texte  afin  de
  325.       pouvoir remettre rapidement toutes les fenêtres  en  place  lors  de  son
  326.       réveil. Ceci a l'inconvénient de ne pas libérer toute la mémoire possible
  327.       aussi, lorsque vous lui demanderez de s'iconifier, ADoc vous demandera si
  328.       vous voulez fermer toutes les fenêtres. Si vous répondez oui, la  mémoire
  329.       sera complètement libérée, et lorsque vous réveillerez ADoc, il affichera
  330.       la requête de terme.
  331.  
  332.   A propos... 
  333.       Affiche quelques informations sur  ADoc.  Cliquez  à  l'intérieur  de  la
  334.       fenêtre ou appuyez sur une touche pour continuer.
  335.  
  336.   Quitter 
  337.       Vous permet de quitter ADoc (avec confirmation). 
  338.    
  339. LeMenuOutils
  340.    
  341.   Ecran avant 
  342.       Permet d'utiliser ADoc sur un écran déjà ouvert  (par  exemple  celui  de
  343.       votre éditeur de texte). Il vous suffit de mettre l'écran sur lequel vous
  344.       voulez placer ADoc au premier plan, puis de le faire glisser vers le  bas
  345.       pour dévoiler l'écran où est ADoc. Sélectionnez alors cette option : ADoc
  346.       ferme toutes les fenêtres ouvertes, ferme éventuellement  son  écran,  et
  347.       ré-ouvre les fenêtres sur l'écran au premier plan.
  348.  
  349.                                   NOTE IMPORTANTE :
  350.        
  351.           Vous aurez certainement droit à une visite du "Gourou" si l'écran
  352.           où vous avez placé ADoc est fermé avant que  vous  n'ayez  quitté
  353.           ADoc (ou que vous ne l'ayez placé sur un autre écran) 
  354.        
  355.       Notez que cette commande ne marchera pas si vous n'avez  pas  indiqué  de
  356.       police de caractères à utiliser (voir paragraphe AppelDepuisLeCLI) et que
  357.       la police de l'écran au premier plan ne convient pas.
  358.  
  359.   Ferme tout 
  360.       Vous permet de fermer toutes les fenêtres  d'un  seul  coup.  Après  vous
  361.       avoir demandé confirmation, ADoc fermera les  fenêtres  et  affichera  la
  362.       requête de terme.
  363.  
  364.   Cherche 
  365.       Vous permet de lancer une recherche (voir le paragraphe Recherche).
  366.  
  367.   Information 
  368.       Affiche le nombre de fichiers et de  termes  disponibles,  ainsi  que  le
  369.       nombre de fenêtres ouvertes et de lignes affichées. Cliquez sur le gadget
  370.       "Ok" pour continuer. 
  371.    
  372. LeMenuSpécial
  373.    
  374.   Ouvre fichier 
  375.       Vous permet d'ouvrir un  fichier  de  documentation  supplémentaire.  Une
  376.       requête de fichier apparait afin que vous puissiez indiquer le fichier  à
  377.       ouvrir.
  378.  
  379.   Ferme fichier 
  380.       Vous permet de fermer le fichier courant (c'est-à-dire le fichier où  est
  381.       défini le terme affiché dans la fenêtre active). Après vous avoir demandé
  382.       confirmation, ADoc fermera toutes les fenêtres correspondant à ce fichier
  383.       puis fermera le fichier. 
  384.       Notez que cette commande ne marchera que si au moins deux  fichiers  sont
  385.       ouverts. 
  386.    
  387. Recherche
  388.    
  389.           ADoc est capable de chercher  jusqu'à  quatre  chaines  simultanément
  390.   dans les lignes de texte, puis d'afficher la liste des termes correspondants.
  391.   Lorsque vous sélectionnez l'option "Cherche" du menu  "Outils",  une  fenêtre
  392.   apparait avec quatre gadgets de chaine. Il y a également un gadget  "ANNULER"
  393.   pour abandonner l'opération, un gadget "VALIDER" pour lancer la recherche, et
  394.   un menu "Options" :
  395.  
  396.       min = MAJ 
  397.           Demande à ADoc de ne pas différencier les minuscules  des  majuscules
  398.           lors de la recherche.
  399.  
  400.       Toutes chaines 
  401.           Normalement, ADoc cherche tous les termes  qui  contiennent  une  des
  402.           chaines que vous avez entrées. Cette option vous permet  de  chercher
  403.           au contraire les termes qui contiennent TOUTES les chaines indiquées.
  404.            
  405.       Tous fichiers 
  406.           Demande à ADoc de faire la recherche dans tous les fichiers  ouverts,
  407.           et non seulement dans le fichier courant. 
  408.    
  409.           Lorsque vous lancez la recherche, une boîte de requête  apparait.  Le
  410.   gadget  "Arrêter"  vous  permet  d'interrompre  la  recherche.  Une  fois  la
  411.   recherche terminée, l'écran flashera si aucun terme n'a été trouvé. Sinon, la
  412.   requête de terme apparaitra, et affichera la liste des termes trouvés.  Cette
  413.   liste est triée, et elle est conservée en mémoire jusqu'à ce que vous lanciez
  414.   une autre recherche.
  415.  
  416. ConceptsAvancés
  417.    
  418.           ADoc est capable d'associer  automatiquement  plusieurs  fichiers  de
  419.   documentation. Il vous suffit d'indiquer le (ou  les)  noms  des  fichiers  à
  420.   associer sur la première ligne du fichier auquel vous voulez les associer. Si
  421.   cette ligne reste vide, ou commence par un  espace  ou  une  tabulation,  son
  422.   contenu est ignoré. Les noms peuvent être séparés par des espaces ou par  une
  423.   virgule. Vous pouvez indiquer un nom  de  répertoire,  auquel  cas  tous  les
  424.   fichiers de ce répertoire  seront  ouverts  (sauf  les  fichiers  ".info"  et
  425.   ".index").
  426.  
  427.           Pour étendre le jeu des caractères  pouvant  être  utilisés  dans  un
  428.   terme, il vous  suffit  d'indiquer  les  caractères  supplémentaires  sur  le
  429.   seconde ligne du fichier de documentation. Si  cette  ligne  reste  vide,  ou
  430.   commence par un espace ou une tabulation, son contenu est ignoré. Sinon, tous
  431.   les caractères de cette ligne (jusqu'au premier espace, tabulation, barre  de
  432.   fraction ou saut de page) sont ajoutés au jeu de caractères par défaut. Notez
  433.   que cette extension du jeu de caractères ne concernera que ce fichier.
  434.  
  435.           ADoc est capable de charger directement des  fichiers  compactés  par
  436.   "PowerPacker", à  condition  que  la  bibliothèque  "powerpacker.library"  se
  437.   trouve dans le répertoire "LIBS:".  Il  n'est  pas  nécessaire  de  créer  le
  438.   fichier d'index avant le compactage, mais cela est recommandé. ADoc  refusera
  439.   de charger un fichier crypté. 
  440.           Après  décompactage,  le  fichier  sera  recopié  dans   un   fichier
  441.   temporaire placé dans le répertoire "T:". L'utilisation de fichiers compactés
  442.   peut donc poser des problèmes de mémoire, particulièrement si  le  répertoire
  443.   "T:" se trouve sur le disque "RAM:". Le fichier temporaire sera détruit après
  444.   sa fermeture.
  445.  
  446.           ADoc est capable de reconnaitre et d'utiliser les fichiers AutoDoc de
  447.   Commodore. Dans la plupart des cas, aucune modification de ces fichiers n'est
  448.   nécessaire, mais il est quand même conseillé de vérifier  leur  format  :  il
  449.   doit y avoir au moins deux lignes vides au début, suivies  de  la  table  des
  450.   matières, et chaque terme doit commencer en colonne 1. 
  451.           Dans certains cas, il manque les lignes vides au début, et les termes
  452.   commencent en colonne 2, précédés par un caractères "saut de page"  (CTRL-L).
  453.   Le programme "AutoConvert", distribué avec ADoc, vous permettra de  convertir
  454.   ces fichiers au bon format (Note: ce programme ne peut s'utiliser que  depuis
  455.   le CLI). Dans tous les autres cas, il vous faudra convertir les  fichiers  "à
  456.   la main".
  457.  
  458. ModeAREXX
  459.    
  460.           ADoc  ouvre  systématiquement  un  port   compatible   AREXX,   nommé
  461.   "ADoc_rexx". Les messages sur ce port sont attendus en  même  temps  que  les
  462.   messages Intuition sur les fenêtres de texte, et peuvent prendre  les  formes
  463.   suivantes :
  464.  
  465.           quit    quitte ADoc 
  466.           request fait apparaître la requête de terme 
  467.           fscreen fait passer ADoc sur l'écran au premier plan 
  468.           ?terme  lance la recherche du terme  indiqué,  et  affiche  le  texte
  469.                   correspondant s'il est trouvé 
  470.           @fic    ouvre le fichier de documentation indiqué 
  471.    
  472.           Tout autre message sera ignoré. Voici un exemple de programme  AREXX,
  473.   qui demande de l'aide sur le terme "alias" :
  474.  
  475.           /* Demande de l'aide sur "alias" */
  476.           address "ADoc_rexx"
  477.           "?alias"
  478.    
  479.           Notez les guillemets autour des commandes ! 
  480.           Si vous  lancez  ADoc  avec  l'option  AREXX,  le  fonctionnement  du
  481.   programme sera un peu différent : une fois le(s) fichier(s) de  documentation
  482.   ouvert(s), ADoc n'ouvrira pas la requête de terme mais affichera  le  message
  483.   "En attente d'un message AREXX" et attendra des messages sur  le  port  AREXX
  484.   (ou CTRL-C pour quitter). De plus, lorsque la dernière fenêtre  sera  fermée,
  485.   le programme ne se terminera pas mais repassera en attente de messages AREXX.
  486.    
  487. LesMessagesDeADoc
  488.    
  489.           Lorsqu'une erreur se produit, ADoc affiche dans une petite fenêtre un
  490.   nom (de fichier en général) et un code d'erreur. Ce code d'erreur est soit un
  491.   code  d'erreur  AmigaDOS  soit  un  code  interne.  Dans  le   premier   cas,
  492.   reportez-vous à votre manuel de l'AmigaDOS (ou utilisez la commande  "Fault")
  493.   pour avoir plus de détails sur ce code d'erreur. 
  494.           Les codes d'erreur internes sont :
  495.  
  496.           -1      fichier vide
  497.           -2      erreur de lecture
  498.           -3      fichier incorrect (mauvais format, etc...)
  499.           -4      fichier compacté, et "powerpacker.library" absente
  500.           -5      problème lors du décompactage
  501.    
  502.  
  503.  
  504.  
  505.  
  506.  
  507.  
  508.  
  509.  
  510.  
  511.  
  512.  
  513.  
  514.  
  515.  
  516.  
  517.  
  518.  
  519.  
  520.  
  521.  
  522.  
  523.  
  524.  
  525.  
  526.  
  527.  
  528.  
  529.